README.md
Brave Search MCP Server
An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
Features
- Web Search: General queries, news, articles, with pagination and freshness controls
- Local Search: Find businesses, restaurants, and services with detailed information
- Flexible Filtering: Control result types, safety levels, and content freshness
- Smart Fallbacks: Local search automatically falls back to web when no results are found
Tools
brave_web_search
- Execute web searches with pagination and filtering
- Inputs:
query
(string): Search termscount
(number, optional): Results per page (max 20)offset
(number, optional): Pagination offset (max 9)
brave_local_search
- Search for local businesses and services
- Inputs:
query
(string): Local search termscount
(number, optional): Number of results (max 20)
- Automatically falls back to web search if no local results found
Configuration
Getting an API Key
- Sign up for a Brave Search API account
- Choose a plan (Free tier available with 2,000 queries/month)
- Generate your API key from the developer dashboard
Usage with Claude Desktop
Add this to your claude_desktop_config.json
:
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Brave Search
An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
Package Information
3851 stars
Updated 12/4/2024
Created 11/19/2024
MIT License
Organization
modelcontextprotocolContributors
jspahrsummers dsp-ant maheshmurag jackadamson ItsBarryZ GarvanD Skirano maledorak mikegehard elie executeautomation sergehuber anjor SkywaveTM Taylor4484 mishushakov ferrants Karthik-clearpoint kacperlukawski tb-peregrine p13rr0m fatwang2 zckly polRk varunneal sean-lynch salihergut rorylogue rishikavikondala ProRedCat